home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Musik / cdcoyote2.01 / CD Coyote 2.0.1 Readme < prev   
Text File  |  1994-12-20  |  13KB  |  317 lines
  1. CD Coyote 2.0.1 Readme
  2.  
  3. <There is a HTML version of this Readme at 
  4. http://www.uta.fi/~eesau/macintosh.html>
  5.  
  6. See 'Version history' at the end of this document to find out what's new
  7. in this version.
  8.  
  9. CD Coyote is a program for CD-ROM drive users who listen to audio CD's and
  10. have written disc information to CD Remote DA or AppleCD Audio Player.  With
  11. CD Coyote You can edit the information saved with the CD player without
  12. inserting the CD to the CD-ROM drive.  You can also merge many 'CD Remote
  13. Programs' files to just one so You can share 'CD Remote Programs' files with
  14. your friends.  The only feature in the 1.0.1 version is still there, only
  15. made better.  It means that You can save the informatin to a TEXT file with
  16. more options.  And hey! CD Coyote is still FREE!
  17.  
  18. System Requirements
  19.  
  20. CD Coyote needs System 7 or later to run.  When launched it checks if System
  21. 7 is present and if not it displays an error message and quits.
  22. You also need to have CD Remote or AppleCD Audio Player (or to be precise the
  23. 'CD Remote Programs' file) to get the information from.
  24.  
  25. How to use?
  26.  
  27. CD Coyote has full Balloon Help.  To learn how to use it just turn on Balloon
  28. Help and start using it.  However here is a description of the program.
  29.  
  30. When You launch CD Coyote it tries to find 'CD Remote Programs' file from
  31. the Preferences folder and from the System folder.  If it finds it You are
  32. ready to use CD Coyote.  If it doesn't find the 'CD Remote Programs' file You
  33. have to set that by hand by pressing the Set... button in the CD Coyote
  34. window and locate the file from the open dialog that appears.  You may also
  35. drag-and-drop any 'CD Remote Programs' file to the CD Coyote icon and CD
  36. Coyote will use that file.  Current 'CD Remote Programs' file is displayed in
  37. the top  of window and if none is set it displays text 'File not found in the
  38. Preferences or System folder'.
  39.  
  40. NOTE!  CD Coyote saves all the changes You make to the 'CD Remote Programs'
  41. database IMMEDIATELY after you have done them.  This is NOT undoable!  The
  42. only way to get back what You had in a text field is to write it again.
  43. Saving is done every time You change text editing field in the window; that
  44. means that You can undo writing (or Cutting, Pasteing etc.) as long as You
  45. edit the same field.  Remember to make an backup copy of your original 'CD
  46. Remote Programs' file before editing it.  CD Coyote may corrupt the file,
  47. especially when merging files and there is not enough memory to do it.
  48.  
  49. CD Coyote window
  50.  
  51. The window is divided into three areas:
  52. On the top of the window there is two rows of text.  First says 'Current 'CD
  53. Remote Programs' file:' and the second is the path to that file.  If no file
  54. is found the second line says 'File not found in the Preferences or System
  55. folder'.  To the right of these rows there is button Set… which is used to
  56. set the 'CD Remote Programs' file CD Coyote uses.
  57.  
  58. In the middle is the Disc list.  Over the list is displayed the total number
  59. of discs in the database. If the database is empty but readable then text
  60. 'current 'CD Remote Programs' file is empty' is displayed.  If this is the
  61. case You can still merge another file into this but obviously You can't save
  62. the list as TEXT.  In the list is four discs visible and on the right of the
  63. list is scrollbar that you can scroll other discs to sight.  Currently
  64. selected disc has its number boldfaced.
  65.  
  66. On the bottom is the track list.  Over the list is displayed how many tracks
  67. is on the currently selected disc and also the total number of tracks on all
  68. discs.  In the list is ten tracks visible and on the right there is again a
  69. scrollbar to scroll other tracks to sight.
  70.  
  71. The window is not resizeable nor are the the two lists.  You can move the
  72. window anywhere on screen and CD Coyote remembers that position next time
  73. You use it.  Also there is a closebox which when clicked quits CD Coyote.
  74.  
  75. Editing the info in the database
  76.  
  77. To edit disc or track name just click on it and a black frame is drawn around
  78. it and the text is selected and editable.  When editing the normal text edit
  79. functions in the Edit menu are usable.  If You press tab or return keys when
  80. disc is currently selected then the first track in the tracklist is selected.
  81. Always when a track is selected and tab or return is pressed the next track
  82. is selected.  If the last track is selected and tab or return is pressed the
  83. disc title is selected.  And remember: all changes are saved right after You
  84. have done them.
  85.  
  86. When editing the text in field You are able to type only 62 characters.  This
  87. limitation is there because this is how AppleCD Audio Player works.  I have
  88. no idea why.  Also when Pasteing text to a field if it will be more than 62
  89. characters the text will not be pasted.  If the text to be pasted includes
  90. returns they are converted to spaces.
  91.  
  92. Menus and what they do
  93.  
  94. Apple menu
  95.     About CD Coyote…        Displays an about dialog.
  96.  
  97. File menu
  98.     Save As TEXT…        Saves disc info to the disk as a TEXT file.  All
  99.                         options from 'Saving List…' dialog are used.
  100.  
  101.     Merge File…            Merges another 'CD Remote Programs' file to
  102.                         currently open file.  Options from 'Merging Files…'
  103.                         dialog are used.
  104.  
  105.     Close                Quits CD Coyote.  Same as clicking the windows
  106.                         close box.
  107.  
  108.     Quit                Quits CD Coyote.  Same as clicking the windows
  109.                         close box.
  110.  
  111. Edit menu
  112.     Undo                Undoes the last action if it is undoable. Undoable
  113.                         actions are text editing within one field.
  114.  
  115.     Cut                    Normal text editing functions.
  116.     Copy
  117.     Paste
  118.     Clear
  119.  
  120.     Select All            Selects the text in the currently active text
  121.                         editing field.
  122.  
  123.     Preferences            Has two submenus: Saving List… and Merging Files…
  124.                         which both open an preferences dialog.
  125.     
  126. Saving List preferences dialog
  127.  
  128. CD Coyote allows You to set various options that affect the information and
  129. layout of the output file when Save As TEXT is selected in the File menu.
  130. Options are set by clicking appropriate buttons. Options and their meanings
  131. are:
  132.  
  133. Option                Meaning
  134.  
  135. Get CD Titles        If this option is checked CD Coyote will get the CD
  136.                     titles.  If not checked, the titles are omitted.
  137.  
  138. Number Titles        If this option is checked CD Coyote will number the CD
  139.                     titles.  If not checked, the titles are not numbered.  If
  140.                     You didn't check the Get CD Titles this has no effect.
  141.  
  142. Get Track Names        If this option is checked CD Coyote will get the track
  143.                     names.  If not checked, the tracks are omitted.
  144.  
  145. Number Titles        If this option is checked CD Coyote will number the
  146.                     track names.  If not checked, the tracks are not
  147.                     numbered.  If You didn't check the Get Track Names this 
  148.                     has no effect.
  149.  
  150. Delimiter:
  151.  
  152. Between Each Disc    This option lets You choose whether to put a tab,
  153.                     return or some other mark between each discs' info.
  154.                     See more about this at chapter 'Special note about the
  155.                     Other Delimiter field'.
  156.  
  157. Before Track List    Same as Disc Delimiter only now between disc title and
  158.                     the tracks.  See more about this at chapter 'Importing
  159.                     disc list to a database or a spreadsheet program'.
  160.  
  161. Between Each Track     Same as Disc Delimiter only now between tracks.
  162.  
  163. Empty Line Between Discs    If this option is checked CD Coyote will add
  164.                             an empty line after each disc.
  165.  
  166. Empty Line After Disc Title    If this option is checked CD Coyote will add
  167.                             an empty line after disc title.  Note that if
  168.                             You are only saving the disc titles and have
  169.                             both Empty Line Between Discs and Empty Line
  170.                             After Disc Title checked You will get two
  171.                             empty lines between the titles.
  172.  
  173. TEXT File Creator    Allows You to specify creator for the output file.
  174.                     You can either select one from the popup menu or
  175.                     write one by yourself to the field.  If You write
  176.                     one it will be added to the popup menu.  Note that
  177.                     only the first four characters of the field are used
  178.                     as a creator.  If You write less than four characters
  179.                     ?'s are added to the creator to get four characters.
  180.                     Predefined creators in the popup menu are:
  181.                     R*ch - BBEdit
  182.                     ttxt - TeachText
  183.                     WORD - MacWrite
  184.                     MWII - MacWrite II
  185.                     MSWD - MicroSoft Word
  186.  
  187. Special note about the Other Delimiter field
  188.  
  189. If Other is selected CD Coyote will parse the field as follows:
  190. If the first character in the field is ^ then any numbers after it are read
  191. as decimal numbers and used as a ASCII value.  For example: ^65 means ASCII
  192. 65 which is A.
  193. If the first character in the field is $ then any hexadecimal numbers after
  194. it are read as hexadecimal numbers and used as a ASCII value.  For example: 
  195. $4A means ASCII 74 which is J.
  196.  
  197. Merging Files preferences dialog
  198.  
  199. This dialog has only three radio buttons that affect the way CD Coyote
  200. behaves when a disc found in the file to be merged is allready in the
  201. database.
  202.  
  203. If 'Never replace' is choosed CD Coyote ignores the disc in the new file
  204. and leaves the original in the database.
  205. If 'Confirm before replacing' is choosed CD Coyote asks if the disc should
  206. be replaced or not.
  207. If 'Replace without confirming' is choosed CD Coyote will replace the disc
  208. without asking if it shoud replace it.
  209.  
  210. It is always a good idea to make a backup copy of Your original 'CD Remote
  211. Programs' file before merging files.
  212.  
  213. Importing disc list to a database or a spreadsheet program
  214.  
  215. If You are using CD Coyote to save list of the discs and want to import
  216. that list to a database or a sreadsheet program there are a couple of
  217. things You should know.  Use return as delimiter between each disc and tab
  218. before track list and between aech track.  Both empty line between discs and
  219. titles should be unchecked.  When these options are in effect and You save
  220. the output file You can import it to most database or sreadsheet programs as
  221. tabulated text.  When You import the file set the record delimiter to return
  222. and field delimiter to tab.
  223.  
  224. FileMaker Pro users can use the Other field to make tracks an repeating
  225. field.  Use return as delimiter between each disc and tab before track list.
  226. Between each track choose Other and write to the other field '^29' or '$1D'
  227. (without quotes).  This is the value that FileMaker Pro uses as a delimiter
  228. between its repeating fields.  When You import the saved list to FM Pro
  229. first make a repeating field and when importing put the tracks go to that
  230. field.
  231.  
  232. Why the name CD Coyote?
  233.  
  234. Someone asks this anyway so here it is  :-)
  235. I happen to be a great fan of Wile E. Coyote and this is a tribute to him.
  236.  
  237. Thanks to
  238.  
  239. Kätsä Lähteenaho for the Icons and the Wile picture in the About box.
  240. Matthew Xavier Mora for the PathNameFromFSSpec function.
  241. My kids Tytti and Aleksanteri who love to watch cartoons with me.
  242. Wile E. Coyote - The Greatest Genius In History.
  243. Heini for being there.
  244. jong15@aol.com & Michael Whitney <michael_whitney@qm.claris.com> for
  245. telling me about FileMaker Pro's repeating fields.
  246.  
  247. DISCLAIMER
  248.  
  249. Use at Your own risk.  I don't take any responsibility of the damages
  250. CD Coyote may cause.  It hasn't caused any as far as I know.
  251.  
  252. Redistribution
  253.  
  254. CD Coyote copyright © 1993-1994 by Esa Ristilä.
  255. CD Coyote is distributed FREE of all charges.  Distribute unmodified
  256. copies freely as long as this Readme file is included in the package and
  257. no money is charged.
  258. If You wish to include CD Coyote on a commercial CD-ROM, BBS or other package
  259. ask for a written permission.  You are very likely to get it.
  260.  
  261. Contacting the author
  262. Bugreports, donations and postcards most welcome  :-)
  263.  
  264. Postcards:    Esa Ristilä
  265.             Ratakatu 11 as. 11
  266.             33250 TAMPERE
  267.             FINLAND
  268.  
  269. Email:        eesau@uta.fi
  270.  
  271. WWW:        http://www.uta.fi/~eesau/
  272.  
  273. IRC:        eesau
  274.  
  275. Version history
  276.  
  277. CD Coyote 2.0.1 - 21st of November 1994
  278.  
  279.     BugFix release, fixed bugs are:
  280.     
  281.     - If there was zero sized 'CD Remote Programs' file in the preferences
  282.       folder CD Coyote crashed when trying to open it at launch. Now displays
  283.       message that the file can't be used.
  284.     - On b/w only machines CD Coyote tried to open color window and crashed.
  285.       Now it checks if machine is b/w only.
  286.     - On 9" screens windows titlebar was under the menubar.
  287.     - Drag and dropping an empty 'CD Remote Programs' file doesn't leave
  288.       first disc in the last file visible any more.
  289.     - Drag and dropping now always selects first disc if file wasn't empty.
  290.     - Other minor changes (did those error checkings finally).  :-)
  291.  
  292.  
  293. CD Coyote 2.0 - 25th of October 1994
  294.  
  295.     Ability to edit all disc titles and track names without inserting the CD
  296.     to the CD-ROM drive.
  297.  
  298.     Ability to merge many 'CD Remote Programs' files to one.
  299.  
  300.     New user interface.
  301.  
  302.     Saving list to a TEXT file has new option.  It is now possible to use any
  303.     character as delimiter between the fields.
  304.  
  305. CD Coyote 1.0.1 - 12th of October 1993
  306.  
  307.     Added to look for 'CD Remote Programs' file from System folder too.   The
  308.     assumption that the file is always in the Preferences folder occurred to
  309.     be fairly stupid.
  310.     
  311.     Removed the automatic save when 'CD Remote Programs' file was
  312.     drag-and-dropped to CD Coyote.
  313.     
  314. CD Coyote 1.0 - 7th of October 1993
  315.  
  316.     First release
  317.